home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk43 / screenx22 / screenx.doc < prev    next >
Text File  |  1995-03-18  |  9KB  |  193 lines
  1.  
  2.                 ScreenX Documentation - By Steve Tibbett.
  3.  
  4.  
  5. ScreenX is a program designed to be put into your Startup-Sequence.  It
  6. provides a number of things that are already available in different
  7. packages, along with a couple of its own twists.
  8.  
  9.  
  10. NOTE: INFO NEW TO V2.2 IS AT THE END OF THIS DOCUMENT.
  11.  
  12.  
  13. Clearly Written Documentation??  Come on, it's a PD program!!
  14.  
  15.  
  16. ScreenX's major functions are:
  17.  
  18.  1: Provide a small clock/memory counter on the Workbench Screen,
  19.     which will take very little processor time, yet be accurate.
  20.  
  21.  2: Provide a means to recover those screens that are "Lost" behind
  22.     those stupid programs that don't bother to put Depth gadgets
  23.     on their screens.  i.e., Chessmaster.
  24.  
  25.  3: Provide an easy way to save a screen to an IFF file (Easier than
  26.     "Flip the screen you want to the front within 10 seconds" anyway).
  27.  
  28.  4: Give me something to do for a couple of evenings.
  29.  
  30.  5: Be small enough to be put into your Startup-Sequence and not take
  31.     much memory.
  32.  
  33.  
  34. ScreenX accomplishes all of these quite well.
  35.  
  36. ScreenX has two modes of operation:  When it is "Awake", and when it is
  37. "Sleeping".  When it is sleeping, it is sitting on the WorkBench screen
  38. showing you how much Chip and Fast RAM you have, and the current time. If
  39. you click in the ScreenX window (thus activating it - You cannot tell if the
  40. window is active or not because of the text that's being printed on the
  41. title bar.  Just click in it and you will know it's active).  When its
  42. window is active, you can either tap the [SPACE] Bar or the right mouse-
  43. button to "wake up" ScreenX.
  44.  
  45. When ScreenX is awake, it opens up its own screen (taking about 25K of
  46. memory doing so, which is why I made the small window in the first place). 
  47. On the left of this screen is a list of all the screens that are currently
  48. in the system, and on the right of the screen are seven gadgets allowing you
  49. to tell the program what to do.
  50.  
  51. These gadgets are:
  52.  
  53.    Pop Screen To Front:  This gadget will take the currently selected
  54.                          screen and pop it to the front.  Handy for getting
  55.                          "hidden" screens back.
  56.  
  57.    Push Screen To Back:  If you have 4 screens in memory, and one of them
  58.                          doesn't have a Depth gadget, you can push that
  59.                          one to the back, and as long as you don't click any
  60.                          of the other screens back behind it, you won't
  61.                          have any problems (if you do click anything else
  62.                          behind it, you'll have to use ScreenX to get them
  63.                          back!).
  64.  
  65.   Update Screen List:  This will redraw the list of screens that is
  66.                        being shown.  Necessary if any of the screens
  67.                        listed leave while you are looking at them, or if
  68.                        new screens appear.   Note that any action taken on
  69.                        a screen that is no longer around is ignored (even
  70.                        clicking on it).
  71.  
  72.   Cycle All Screens:  I'll let you figure this one out on your own.  Note
  73.                       that to make it stop, you must click anywhere in the
  74.                       main ScreenX screen...
  75.  
  76.   Close Screen:  Danger.  You got it.  This isn't something you should be
  77.                  doing unless you KNOW what you are doing.  It will let
  78.                  you CLOSE DOWN the screen of your choice.  The problem
  79.                  with this is that if anybody else decides to write on that
  80.                  screen at any time, BOOMO.  What it's really useful for is
  81.                  when a program crashes, you can close its screen to free
  82.                  up a bunch of Chip RAM that is tied up.  Just make sure
  83.                  you don't go closing the WorkBench down, or something
  84.                  stupid like that.  OK?
  85.  
  86.   Save Screen to IFF File:  This gadget will instantly turn the screen red
  87.                 (So you know something's going on), and save the screen
  88.                 selected to the filename in the Text gadget at the bottom
  89.                 of the screen.  Note that the filename in that gadget must
  90.                 include the full pathname, or else if you just type a
  91.                 filename in there, it will be written to the current
  92.                 directory.
  93.  
  94.  
  95.  
  96. Oh yeah... there are a couple of command line options for this thing too.
  97.  
  98. COMMAND LINE OPTIONS:
  99.  
  100. There are a couple of options you might want.
  101.  
  102.   -C : This will DISABLE changing color 0 to White and color 1 to Black for
  103.        printing purposes.  Without this option, when you tell it to print a
  104.        screen, color 0 and color 1 become white and black, which makes the
  105.        printout usually look better (depending on what you are printing).
  106.        If you are printing digitized pictures, or anything else where the
  107.        colors actually matter, then you NEED this option.
  108.  
  109.   -E : ScreenX will eat up about 5% of the processor's time keeping the memory
  110.        display accurate.  If you don't like this, you can put "-E" on the
  111.        command line, which will tell it to only update the display about
  112.        once every second and a half - this way, it's really taking NO
  113.        time.
  114.  
  115.   -F : This option will display the free memory as BYTES rather than
  116.        as K.  It makes the window a little bigger, but some people
  117.        like seeing 200000 rather than 200.
  118.  
  119.  
  120.         ...Steve Tibbett
  121.            2710 Saratoga Pl. #1108
  122.            Gloucester, Ontario
  123.            K1T 1Z2
  124.  
  125.     (or just call my BBS at 613-731-3419).
  126.     (or send me BIX mail at 'S.Tibbett')
  127.     (or Plink mail at "STEVEX")
  128.  
  129. Actually, if you want the source for it, send me a disk with some sort of a
  130. return mailer thing (maybe even throw in some cash, eh?), and I'll send it
  131. to ya.
  132.  
  133.  
  134. /*****************************************************************/
  135.  
  136. NEW INFO FOR V2.1 OF SCREENX:
  137.  
  138. I don't think anybody ever actually wanted ScreenX to come up with the big
  139. window open, so I took that option out altogether.  When you say "Run
  140. ScreenX", it just opens the small window.
  141.  
  142. Put ScreenX in your startup sequence!
  143. (This has changed - see the V2.2 notes)
  144.  
  145. I added the ability to print screens.  Click on the screen you want printed,
  146. and then click on "Print Screen" and it will start doing it.  If you click
  147. on the Print Screen gadget while the screen is being printed, it will
  148. usually STOP the print (unlike most programs that tell you to click stop,
  149. but really they just ignore you).
  150.  
  151. A little warning here about printing screens:  Just after I added the Print
  152. Screen gadget, while I was testing it, I ran into a weird problem - I could
  153. print, say, the DiskX screen, but if I tried to print the ScreenX screen, or
  154. the Workbench screen, I'd get a blank page.  Well, after THREE HOURS of
  155. working on this (starting at 11 PM...), I finally figured out that if your
  156. preferences are set for Black and White, and your screen colors are sorta
  157. not far enuf apart to be Black and White, it will print all white - White's
  158. an easy color to print... see the command line options above.
  159.  
  160. Another new gadget: Screen Info.  What this does, is tell you my BBS
  161. number!  There are also some less useful stats there, like the current
  162. font that screen is using, the amount of memory that screen is using
  163. (Note: If it says 32K, it really means 32000 bytes), the number of
  164. Windows open on that screen, and the number of Gadgets on that screen.
  165. The depth of that screen too - Depth = Number Bitplanes (it's always
  166. fun to run a bunch of programs, and then try to find all the gadgets).
  167.  
  168. Ummmm, that's about it for now, I guess.  If anybody can think of some
  169. more stats to stick in the "Screen Info" window, let me know - I  sure
  170. can't.
  171.  
  172.  
  173.    /******************************************************************/
  174.  
  175.  
  176. V2.2 NOTES:
  177.  
  178. This version has only three enhancements.
  179.  
  180. First, if you click in the title-bar-window, and tap [F], it will change its
  181. display to "Largest:" and show you the Largest fragment of memory left in
  182. that section (if your largest memory fragment is too small, it's like you
  183. don't have any memory left).
  184.  
  185. Secondly, if you put "-F" on the command line, instead of showing you the
  186. number of K you have free, it will show you the number of BYTES free.
  187.  
  188. Lastly, you NO LONGER NEED RunBack to put this in the Startup-Sequence!  Just
  189. put "SCREENX" on a line by itself.  No RUN needed either!  If you want
  190. ScreenX to come up when you boot, just copy ScreenX V2.2 into the "C"
  191. directory (or onto the root directory) of your boot disk.  Then, anywhere in
  192. your startup-sequence (before the ENDCLI of course), just put "ScreenX".
  193.